home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 32 / teraform.zip / TERAFORM.DOC < prev    next >
Text File  |  1991-02-13  |  14KB  |  374 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     Teraform 1.2
  8.                           A SimCity fractal terrain former
  9.  
  10.                        Copyright 1990, 1991 by David M. Hayden
  11.                                  All rights reserved
  12.  
  13.             INTRODUCTION
  14.  
  15.             Teraform is a utility for the IBM PC and compatibles that
  16.             lets you create new terrains for SimCity.  These terrains
  17.             have, in my opinion, a more natural look than the ones
  18.             obtained directly from SimCity.  Teraform supports cga, ega,
  19.             vga and hercules graphics.  Teraform is not  a replacement
  20.             for the Maxis terrain editor - it has only minor editing
  21.             capabilities.  However, it can quickly produce interesting,
  22.             realistic, and challenging terrains for your simming
  23.             pleasure.
  24.  
  25.             Teraform creates its terrains using fractal math.  First, it
  26.             creates a topographical map of the area.  It then selects
  27.             three topographic "altitudes" which divide the area into
  28.             four regions.  Everything below the lowest altitude becomes
  29.             a shipping channel.  Everything in the next region up
  30.             becomes water.  The next region is open land, and the last
  31.             region is forest.  You can change the layout of your terrain
  32.             by raising and lowering the altitudes that determine the
  33.             borders of the regions.
  34.  
  35.             One of teraform's nice features  is it's ability to "smooth"
  36.             a terrain.  This gives your terrain smooth borders between
  37.             water, sea, and forest instead of the square, pre-bulldozed
  38.             borders one might expect.
  39.  
  40.             Teraform is copyrighted shareware.  Under the shareware
  41.             concept, you pay for software only after you have tried it
  42.             and determined that you want to keep it.  You may try out
  43.             teraform free of charge.  If you decide to keep it, please
  44.             send $10 (U.S.) to:
  45.  
  46.                                 David Hayden
  47.                                 6208 Collinsway Road
  48.                                 Baltimore, Maryland, 21228
  49.                                 USA
  50.  
  51.             You may distribute teraform freely, provided that you do so
  52.             without charge.  You may not sell teraform.  Shareware
  53.             distributors and bulletin board operators may charge a
  54.             reasonable fee for operating and duplication expenses.
  55.  
  56.             INSTALLATION
  57.  
  58.             Teraform is distributed in a single compressed "zip" file.
  59.             To extract the files, get pkunzip, change directories to
  60.  
  61.  
  62.  
  63.                                        Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.             where you'd like the files to reside (probably the same
  70.             directory where you keep SimCity)  and execute:
  71.  
  72.                                 pkunzip teraform
  73.  
  74.             This will extract the following files:
  75.  
  76.                                 teraform.exe
  77.                                 teraform.dat
  78.                                 egavga.bgi
  79.                                 cga.bgi
  80.                                 herc.bgi
  81.                                 teraform.doc
  82.                                 trip.chr
  83.  
  84.             Please note that you MUST execute teraform in the directory
  85.             containing teraform.dat and the ".bgi" files.
  86.  
  87.             RUNNING TERAFORM
  88.  
  89.             To run teraform, change directories to the directory
  90.             containing teraform and its associated files and type:
  91.  
  92.                                       teraform
  93.  
  94.             Teraform displays the message "Now Terraforming" while it
  95.             creates a landscape.  THIS MAY TAKE SOME TIME.  Please don't
  96.             panic if nothing appears to be happening.  Teraform uses
  97.             lots of  math creating the topographical map.  It may take a
  98.             full minute on a computer without a coprocessor, or less
  99.             than a second on a fast 386 with coprocessor or 486.
  100.  
  101.             If more than a minute elapses and nothing has happened, then
  102.             teraform may have incorrectly identified your graphics
  103.             hardware.  Teraform tries to determine what graphics
  104.             hardware you are using automatically, but it may guess
  105.             incorrectly.  Fortunately, you can override teraform's
  106.             guess.  Simply restart teraform with the "/c", "/e", "/h",
  107.             or "/v" option to tell it you are using cga, ega, hercules,
  108.             or vga graphics respectively.  For example, to start
  109.             teraform and force it to use ega graphics, type:
  110.  
  111.                                      teraform /e
  112.  
  113.             When teraform completes the topographic map, it tries to
  114.             determine reasonable levels for shipping channels,
  115.             coastlines, and forest lines.  It then displays the main
  116.             teraform screen described below.
  117.  
  118.             THE MAIN TERAFORM SCREEN
  119.  
  120.             The main teraform screen displays a map of the current
  121.             terrain, and lists the commands available.   The upper left
  122.             portion  of the screen shows a map of the terrain.  In the
  123.  
  124.  
  125.                                        Page 2
  126.  
  127.  
  128.  
  129.  
  130.  
  131.             upper right corner is a legend showing what each color or
  132.             pattern in the map represents.  On the bottom of the screen
  133.             is a list of your available commands:
  134.  
  135.                 PgUp/PgDn        These keys raise and lower the
  136.                                  water level of the terrain.
  137.                                  Raising the water level floods
  138.                                  portions of the land and creates
  139.                                  more water.  Lowering the water
  140.                                  level gives you more useable
  141.                                  land.
  142.  
  143.                 UpArrow/DnArrow  The up and down arrows keys raise
  144.                                  and lower the "forest level."
  145.                                  Everything above a certain level
  146.                                  on the topographical map becomes
  147.                                  forest.  Lowering the forest
  148.                                  level creates more forest while
  149.                                  raising it creates less.  If you
  150.                                  try to lower the forest level
  151.                                  below the water level, teraform
  152.                                  beeps at you and lowers the water
  153.                                  level with the forest level.
  154.  
  155.                 Home/End         These keys raise and lower the
  156.                                  shipping channel level.  Raising
  157.                                  the channel level creates more
  158.                                  space where ships can navigate.
  159.                                  Lowering it restricts ships.  You
  160.                                  should be sure to have a clear
  161.                                  path for ships from your land to
  162.                                  off the terrain.
  163.  
  164.                 o                The "o" key pops up the options
  165.                                  menu (described below).  The
  166.                                  options menu lets you smooth or
  167.                                  save the terrain, invert the
  168.                                  features, set the difficulty
  169.                                  level, and change other options.
  170.  
  171.                 q                Quit from the program.
  172.  
  173.             As a shortcut, you may also press the first letter of any
  174.             item in the options menu to activate that item.  The options
  175.             menu is described below.
  176.  
  177.             OPTIONS
  178.  
  179.             Pressing "o" pops up an options menu.  You can select items
  180.             from the options menu in three ways:
  181.  
  182.                       1.  Use the arrow keys to move the
  183.                           highlighted bar over the desired item
  184.                           and press Enter, or
  185.  
  186.  
  187.                                        Page 3
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                       2.  Press the fist letter of the first word
  194.                           of the desired option, or
  195.                       3.  Move the mouse pointer over the option
  196.                           and press the left key.
  197.  
  198.             The options menu contains the following items:
  199.  
  200.                  New Terrain    The creates a new terrain from
  201.                                 scratch.  The existing terrain is
  202.                                 lost.
  203.  
  204.                  Invert Terrain This "inverts" the terrain.
  205.                                 Forests become shipping channels,
  206.                                 open land becomes water, water
  207.                                 becomes open land, and shipping
  208.                                 channels become forests.
  209.  
  210.                  Smooth         This smooths the terrain so that
  211.                                 it won't have pre-bulldozed
  212.                                 coastlines when you use it with
  213.                                 SimCity.  You will see the terrain
  214.                                 change slightly so that it can be
  215.                                 smoothed, but otherwise, the
  216.                                 picture will not show smooth
  217.                                 borders.  Please note that if you
  218.                                 change the water or forest level
  219.                                 after smoothing, you will have to
  220.                                 resmooth the picture before saving
  221.                                 it.
  222.  
  223.                  Difficulty     This pops up a submenu that lets
  224.                                 you set the difficulty of your
  225.                                 city to easy, medium, or hard.
  226.                                 The default difficulty is taken
  227.                                 from teraform.dat (see below).
  228.  
  229.                  Millennia      This item lets you set the number
  230.                                 of millennia that terafrom will
  231.                                 spend smashing continents when it
  232.                                 creates new terrains.  The default
  233.                                 is 200.  Higher values will create
  234.                                 more jagged landscapes, lower
  235.                                 values result in less jagged
  236.                                 landscapes.  If you reduce this
  237.                                 value too much, the landscape will
  238.                                 look like a bunch of strange
  239.                                 polygons.  This is because of the
  240.                                 way terafrom generates landscapes.
  241.  
  242.                  Write          Write the current terrain out to a
  243.                                 file.  If the terrain hasn't been
  244.                                 smoothed, teraform asks if you'd
  245.                                 like to smooth it.  Answer "y" to
  246.                                 smooth the terrain before saving
  247.  
  248.  
  249.                                        Page 4
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                                 it, "n" to leave it unsmoothed, or
  256.                                 press Esc if you don't want to
  257.                                 save the file.  Teraform now asks
  258.                                 what to name the city.  The name
  259.                                 you type will appear across the
  260.                                 top of the SimCity edit window
  261.                                 while you're running SimCity.
  262.                                 Next, teraform prompts you for the
  263.                                 file name where it will store the
  264.                                 city.  After you enter the name,.
  265.                                 teraform saves the city.  The file
  266.                                 is written in SimCity's ".cty"
  267.                                 format with all parameters set to
  268.                                 be the same as a new city at the
  269.                                 level of difficulty you selected
  270.                                 ("easy" by default).  You can load
  271.                                 the new city with the "load city"
  272.                                 command from SimCity's "system"
  273.                                 menu.
  274.  
  275.             COMMAND LINE PARAMETERS
  276.  
  277.             The teraform command line looks like this:
  278.  
  279.                            teraform [options] [millennia]
  280.  
  281.             Where "options " can be either of the following:
  282.  
  283.                                 /c   use cga graphics
  284.                                 /e   use ega graphics
  285.                                 /h   use hercules graphics
  286.                                 /v   use vga graphics
  287.  
  288.             and "millennia" tells for how many thousands of years
  289.             teraform should simulate continents smashing into each
  290.             other.  The default is 200.  Larger values give more jagged
  291.             coastlines but take ore time.  Smaller values give less
  292.             jagged but less random coastlines.
  293.  
  294.             TERAFORM.DAT
  295.  
  296.             There is a great deal of information stored in SimCity's
  297.             ".cty" files besides the general landscape of the city.  For
  298.             example, the amount of funding available, the buildings in
  299.             the landscape, the date, and more.  Teraform reads this
  300.             information from the file teraform.dat, which is actually
  301.             nothing more than ".cty" file created by saving a city
  302.             immediately after it was started.  You can change the
  303.             default teraform parameters by replacing teraform.dat with a
  304.             different file.  For example, if you prefer to play at the
  305.             medium difficulty level, start simcity, and generate a new
  306.             city at the medium difficulty level.  Save the city
  307.             immediately, before you put any buildings on it.  Now copy
  308.  
  309.  
  310.  
  311.                                        Page 5
  312.  
  313.  
  314.  
  315.  
  316.  
  317.             this new city to terafrom.dat.  Teraform now generates
  318.             medium difficulty level cities by default.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.                                        Page 6
  374.